home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / standard / ldgetpd.z / ldgetpd
Encoding:
Text File  |  1998-10-30  |  2.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. LLLLDDDDGGGGEEEETTTTPPPPDDDD((((3333XXXX))))                                                        LLLLDDDDGGGGEEEETTTTPPPPDDDD((((3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ldgetpd - retrieve procedure descriptor given a procedure descriptor
  10.      index
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddiiiioooo....hhhh>>>>
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ffffiiiilllleeeehhhhddddrrrr....hhhh>>>>
  15.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyymmmm....hhhh>>>>
  16.      ####iiiinnnncccclllluuuuddddeeee <<<<llllddddffffccccnnnn....hhhh>>>>
  17.  
  18.      lllloooonnnngggg llllddddggggeeeettttppppdddd ((((ldptr, ipd, ppd))))
  19.      LLLLDDDDFFFFIIIILLLLEEEE ldptr;;;;
  20.      lllloooonnnngggg ipd;;;;
  21.      ppppPPPPDDDDRRRR ppd;;;;
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      _l_d_g_e_t_p_d returns a SUCCESS or FAILURE depending on whether the procedure
  25.      descriptor with index _i_p_d can be accessed.  If it can be accessed, the
  26.      structure pointed to by _p_p_d is filled with the contents of the
  27.      corresponding procedure descriptor.  The _i_s_y_m, _i_l_i_n_e, and _i_o_p_t fields of
  28.      the procedure descriptor are updated to be used in further LD routine
  29.      calls. The _a_d_r field is updated from the symbol referenced by the _i_s_y_m
  30.      _f_i_e_l_d.
  31.  
  32.      The PDR cannot be retrieved when:
  33.  
  34.  
  35.      +o       The procedure descriptor table cannot be found.
  36.  
  37.      +o       The ipd offset into the procedure descriptor table is beyond the
  38.              end of the table.
  39.  
  40.      +o       The file descriptor that the ipd offset falls into cannot be
  41.              found.
  42.  
  43.  
  44.      Typically, _l_d_g_e_t_p_d is called while traversing the table that runs from 0
  45.      to SYMHEADER(ldptr).ipdMax - 1.
  46.  
  47.      The program must be loaded with the object file access routine library
  48.      lllliiiibbbbmmmmlllldddd....aaaa.
  49.  
  50. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  51.      ldclose(3X), ldopen(3X), ldtbseek(3X), ldtbread(3X), ldfcn(4).
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.